home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmatomstr.z / pmatomstr
Text File  |  1997-04-03  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMAAAATTTTOOOOMMMMSSSSTTTTRRRR((((3333))))                                                      PPPPMMMMAAAATTTTOOOOMMMMSSSSTTTTRRRR((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmAAAAttttoooommmmSSSSttttrrrr - convert a performance metric value into a string
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      cccchhhhaaaarrrr ****ppppmmmmAAAAttttoooommmmSSSSttttrrrr((((ppppmmmmAAAAttttoooommmmVVVVaaaalllluuuueeee ****aaaavvvvpppp,,,, iiiinnnntttt ttttyyyyppppeeee))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      All performance metric values may be encoded in a _p_m_A_t_o_m_V_a_l_u_e union,
  20.      defined as follows;
  21.  
  22.           typedef union {
  23.               __int32_t    l;     /* 32-bit signed */
  24.               __uint32_t   ul;    /* 32-bit unsigned */
  25.               __int64_t    ll;    /* 64-bit signed */
  26.               __uint64_t   ull;   /* 64-bit unsigned */
  27.               float        f;     /* 32-bit floating point */
  28.               double       d;     /* 64-bit floating point */
  29.               char         *cp;   /* char ptr */
  30.               void         *vp;   /* void ptr */
  31.           } pmAtomValue;
  32.  
  33.      Given the performance metric value pointed to by _a_v_p, and a performance
  34.      metric type defined by _t_y_p_e, generate the corresponding metric value as a
  35.      string, suitable for diagnostic or report output.
  36.  
  37.      The value for _t_y_p_e is typically extracted from a _p_m_D_e_s_c structure,
  38.      following a call to ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular performance metric.
  39.  
  40.      If the _t_y_p_e is PPPPMMMM____TTTTYYYYPPPPEEEE____SSSSTTTTRRRRIIIINNNNGGGG values longer than 38 characters will be
  41.      truncated after 34 characters, and truncation shown with ellipsis ``...''
  42.      at the end of the value.
  43.  
  44.      If the _t_y_p_e is PPPPMMMM____TTTTYYYYPPPPEEEE____AAAAGGGGGGGGRRRREEEEGGGGAAAATTTTEEEE only the first three 32-bit words are
  45.      displayed as hexadecimal values.
  46.  
  47.      The string value is held in a single static buffer, so the returned value
  48.      is only valid until the next call to ppppmmmmAAAAttttoooommmmSSSSttttrrrr.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmCCCCoooonnnnvvvvSSSSccccaaaalllleeee(3), ppppmmmmEEEExxxxttttrrrraaaaccccttttVVVVaaaalllluuuueeee(3), ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3),
  52.      ppppmmmmPPPPrrrriiiinnnnttttVVVVaaaalllluuuueeee(3), ppppmmmmTTTTyyyyppppeeeeSSSSttttrrrr(3) and ppppmmmmUUUUnnnniiiittttssssSSSSttttrrrr(3).
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.